home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / wb / wbassign1.24.lha / WBAssign124 / WBAssign.TXT < prev    next >
Encoding:
Text File  |  1993-12-29  |  15.4 KB  |  421 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    WBAssign
  9.  
  10.                                  Version 1.24
  11.                               December 29, 1993
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.          ##   ##  #####    #####                 ##                 
  22.          ##   ##  ##  ##  ##   ##                                   
  23.          ##   ##  ##  ##  ##   ##   ####   ####  ##   #####  ## ### 
  24.          ## # ##  #####   #######  ##     ##     ##  ##  ##  ###  ##
  25.          #######  ##  ##  ##   ##   ###    ###   ##  ##  ##  ##   ##
  26.          ##   ##  ##  ##  ##   ##     ##     ##  ##  ##  ##  ##   ##
  27.          #     #  #####   ##   ##  ####   ####   ##   #####  ##   ##
  28.                                                          ##         
  29.                                                       ####          
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.                           Written by El Pedro of LSD
  40.  
  41.                        Copyright (c) 1992,3 by El Pedro
  42.                              All rights reserved
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.      WBAssign V1.21                                  December 29, 1993
  62.  
  63.  
  64. 1. Introduction
  65.  
  66. WBAssign is an Intuition front end designed to simplify  the  use  of  Assigns
  67. for the user. This makes  it  easy  to  install  programs  on  a  hard  drive,
  68. although you may find other uses.
  69.  
  70. This program is NOT Public Domain, but Freely distributable.  No  warranty  is
  71. offered for any damage caused, directly or indirectly, by this program.
  72.  
  73. 1.1. System requirements
  74.  
  75. WBAssign requires Workbench 2.04 or higher to  function.  This  program  works
  76. without a hard drive, but it is not very useful. As this program  was  written
  77. under Workbench 3.0, it supports (but doesn't require) Workbench 2.1  and  3.0
  78. features.
  79.  
  80. 1.2. Why WBAssign?
  81.  
  82. There are many reasons why you might want to use this  program.  For  example,
  83. many newcomers to the Amiga often feel uncomfortable with  using  the  CLI  to
  84. set  up  assigns  or  with  changing  the  startup-sequence  or  user-startup.
  85. WBAssign is designed to appear as part of  the  Workbench,  by  just  dragging
  86. icons about.
  87.  
  88. You may want to use WBAssign to remove some of the clutter  from  the  startup
  89. files and makes it much easier to update Workbench.  Those  of  you  who  have
  90. just upgraded from 2.04 to 2.1/3.0 who have heavily  customised  systems  will
  91. realise how useful that is.
  92.  
  93. 1.3. What is an Assign? (Or: Why doesn't my software work?)
  94.  
  95. You must have tried to install a program to the hard drive  by  just  dragging
  96. the icons across. How many times have you done so, only  to  be  greeted  with
  97. the following requester?
  98.  
  99. Please insert volume
  100. <Program disk's name>
  101. in any drive
  102.  
  103. [ Retry ]  [ Cancel ]
  104.  
  105. Retry won't get rid of the message: it just comes back again. At best,  Cancel
  106. will cause the program to give an error message. At  worst,  the  system  will
  107. guru (however if it  does,  the  program  has  not  been  written  correctly.)
  108. Alternatively, you could put the original disk back in, and the  program  will
  109. then continue to run, but from the floppy instead of the hard disk.
  110.  
  111. The reason the "Please insert ..." message came up is that the  program  asked
  112. for a disk that the Amiga does not have handy, so AmigaDOS asked  for  a  disk
  113. with that name.  However, all you have to do is tell the Amiga that  the  disk
  114. is really just a directory on your hard drive, using an assignment.
  115.  
  116. So, to answer the question, an assignment is a "virtual disk" in that  when  a
  117. program asks for a disk, it is pointed to the hard drive. WBAssign  just  sets
  118.  
  119.  
  120.                                     - 2 -
  121.      WBAssign V1.21                                  December 29, 1993
  122.  
  123.  
  124. up these assignments.
  125.  
  126. 1.4. Installation
  127.  
  128. All you have to do to install this program  is  to  drag  its  icon  into  the
  129. WBStartup drawer on your Workbench partition. Now, the  program  will  be  run
  130. every time you reboot. You will probably want to edit WBAssign's tooltypes  to
  131. your own taste. To start it now, for a test drive, then  double-click  on  the
  132. WBAssign icon. There are no other files to copy,  eg  to  FONTS:  and  so  on.
  133. WBAssign will only write files to the drive if you  select  "Save",  or  "Save
  134. As...".
  135.  
  136. 2. Using WBAssign
  137.  
  138. The simplest, and often the  best  way  to  use  WBAssign  when  installing  a
  139. program is as follows:
  140.  
  141. · First, copy the program to the hard drive by dropping the  icon(s)  for  the
  142. program disk(s) that you wish to install onto the hard  drive,  as  you  would
  143. usually do.
  144.  
  145. · Run the program to see if it actually  needs  an  assign.  If  you  get  the
  146. "Please insert ..." requester, then you  do.  With  any  luck,  the  name  the
  147. requester asks for is the name of the disk that you have  just  copied,  which
  148. is also the name of the drawer created by the copy. If not, then  the  program
  149. is using its own special assigns, in which case they will be documented  along
  150. with the program. Do not cancel the requester.
  151.  
  152. · Open WBAssign's window by pressing the CTRL, ALT, and W  keys  (or  whatever
  153. you defined the hotkey as) together. This will open the window.
  154.  
  155. · Drag the program's drawer icon(s),  which  appeared  after  you  copied  the
  156. disk, and drop it over the WBAssign window. This will tell WBAssign to  create
  157. an assign for you. Do this for each of the disks that the program asks for.
  158.  
  159. · Click "Retry" on the  "Please  insert  ..."  requester.  It  should  now  be
  160. satisfied, and the program should run. Repeat the  last  few  steps  for  this
  161. requester.
  162.  
  163. · Finally, click "Save" to make the assigns, and to save them to disk so  that
  164. they will be remade when you reboot.
  165.  
  166. 2.1. The control window
  167.  
  168. WBAssign talks to you through a control  window.  The  control  window  is  an
  169. AppWindow - this means that you can drop nearly any icon onto the window,  and
  170. an appropriate assign will be created. The device name will be the  name  that
  171. Workbench has for the item, and this will be made an Add  assign  by  default.
  172. Unlike many such editors, WBAssign will attempt  to  make  the  assignment  as
  173. soon as you type it in, rather that when you click "Use".
  174.  
  175. Assigned Devices
  176.  
  177. This is a list of the device names that you have chosen to assign to, as  well
  178.  
  179.  
  180.                                     - 3 -
  181.      WBAssign V1.21                                  December 29, 1993
  182.  
  183.  
  184. as some information about the assign. There is one  entry  in  this  list  for
  185. each of the assignments you have defined. An entry looks something like this.
  186.  
  187.  +  FOOBAR   M   *
  188. (1)   (2)   (3) (4)
  189.  
  190. (1) This denotes the type of assign. There is "  "  (nothing)  for  a  replace
  191. assign, "+" for an add assign, "P" for a path assign, and "D" for  a  deferred
  192. assign.
  193.  
  194. (2) This is the device name that the assignment is made to.
  195.  
  196. (3) If there is a "M" here, then there is a directory created  for  the  item.
  197. (M for Makedir)
  198.  
  199. (4) If there is a "*" here, then the  assignment  couldn't  be  made.  Usually
  200. this is because the disk/directory/file that you assigned to does  not  exist.
  201. WBAssign have complained before you see this.
  202.  
  203. If you click on one of the entries, then more about the  assign  is  shown  on
  204. the right, so you can edit it.
  205.  
  206. New (Hotkey N)
  207.  
  208. This creates a  new  "blank"  assignment,  so  that  you  can  enter  all  the
  209. information about an assignment manually.
  210.  
  211. Del (Hotkey L)
  212.  
  213. This removes the selected assign.
  214.  
  215. Assignment Name
  216.  
  217. This is the device name for the assignment. AmigaDOS does not allow  an  empty
  218. assignment name, so no assignment will  be  made  if  this  is  empty.  It  is
  219. possible, however to have a space here, which could prove confusing...
  220.  
  221. Replace (Hotkey R)
  222.  
  223. This changes the type of the current assign into a replacing assign.  This  is
  224. the normal kind of assign, and is the only one  that  was  in  Kickstart  1.3.
  225. Such an assign will cancel all previous assigns to the same device name.  This
  226. kind of assign is the one usually used for setting up  software  on  the  hard
  227. disk.
  228.  
  229. Add (Hotkey A)
  230.  
  231. This changes the type of the  current  assign  into  an  adding,  or  multiple
  232. assign. A multiple assign will allow an  assignment  name  to  refer  to  many
  233. paths. This kind of assign may be useful for adding font disks to the  system,
  234. where you do not want to lose the fonts already present.
  235.  
  236. You should be warned that many, if  not  most  programs  (which  unfortunately
  237. include all the programs on the Workbench 2.x/3.0  disks)  do  not  understand
  238.  
  239.  
  240.                                     - 4 -
  241.      WBAssign V1.21                                  December 29, 1993
  242.  
  243.  
  244. multiple assignments properly, and can appear to 'lose'  files  which  are  in
  245. added paths. The only way to find out if a program supports  multiple  assigns
  246. is to test it.
  247.  
  248. When you create a new assignment, either by clicking on  the  New  gadget,  or
  249. dropping an icon onto the WBAssign  window,  it  will  be  made  into  an  Add
  250. assignment by default, even though there may not be another assignment to  add
  251. to. This is to avoid overriding another assignment (which is  what  the  other
  252. types do,) unless you really mean it.
  253.  
  254. Although AmigaDOS  doesn't  support  adding  to  a  non  existent  assignment,
  255. WBAssign does, and when the assignment is actually  made,  it  will  create  a
  256. Replace assign instead. You may still wish to set the assign type  to  Replace
  257. for completeness, or to fix some obscure problems.
  258.  
  259. Defer (Hotkey D)
  260. Path (Hotkey P)
  261.  
  262. These are more  complex  assignment  types,  and  should  be  avoided  by  the
  263. beginner. These are rarely used, even by experts, and were added by  Commodore
  264. for a few special cases.
  265.  
  266. A deferred assignment is one  that  is  worked  out  when  the  assignment  is
  267. actually used - so if the assignment is to another disk (eg  a  floppy,  or  a
  268. SyQuest) then you will not be asked to insert the disk  until  the  assignment
  269. is used. Leaving it as a replace assignment means that WBAssign will  ask  for
  270. the disk on startup.
  271.  
  272. A path assignment is an even more severe case,  in  which  the  assignment  is
  273. worked out every time it is used. The standard example is when you  are  using
  274. font disks - you assign "FONTS:" to "DF0:FONTS" and it will look on  whichever
  275. disk is in DF0: at the time when you use fonts. When you change the disk,  the
  276. fonts will be used from the new disk.
  277.  
  278. Make Directory (Hotkey M)
  279.  
  280. If this gadget is checked/ticked (depending on which side of the Atlantic  you
  281. are on...), then, if the directory which WBAssign was given to assign to  does
  282. not exist (for example, if it is in RAM:,)  then  WBAssign  will  create  that
  283. directory, and then point the assignment to that.
  284.  
  285. Assignment Destination
  286.  
  287. This is the pathname that  the  assignment  refers  to,  which  you  can  type
  288. directly if you need to. When you click on the gadget next  to  it,  you  will
  289. get a file requester, to select a directory or  file  to  assign  to.  (Didn't
  290. know you could assign to a file? You know now.)
  291.  
  292. If you give a relative pathname (one without DF0: or whatever in front of  it)
  293. then  it  will  be  relative  to  wherever  you  ran  WBAssign  from  (Usually
  294. SYS:WBStartup.) This is only important if you have WBAssign in two  places  on
  295. your hard drive.
  296.  
  297. Save (Hotkey S)
  298.  
  299.  
  300.                                     - 5 -
  301.      WBAssign V1.21                                  December 29, 1993
  302.  
  303.  
  304.  
  305. This saves the assigns that you have defined to  disk  so  that  they  can  be
  306. restored next time you boot up,  and  then  closes,  leaving  the  assigns  in
  307. place.
  308.  
  309. Use (Hotkey U)
  310.  
  311. This closes the WBAssign window, and leaves the assigns made in place.
  312.  
  313. Cancel (Hotkey C)
  314.  
  315. This cancels the changes that you have made  since  you  opened  the  WBAssign
  316. window.
  317.  
  318. 2.2. Menus
  319.  
  320. Project/Open... (Hotkey Amiga-O)
  321.  
  322. Allows you to load a different  configuration  file  from  the  default.  This
  323. cancels all the other assigns made.
  324.  
  325. Project/Save As... (Hotkey Amiga-A)
  326.  
  327. Allows you to save  to  different  configuration  file  from  the  default  of
  328. "ENVARC:WBAssignList".
  329.  
  330. Project/About (Hotkey Amiga-?)
  331.  
  332. This gives some information about WBAssign.
  333.  
  334. Project/Hide (Hotkey Amiga-H)
  335.  
  336. This hides the WBAssign window, but leaves WBAssign in memory  so  it  can  be
  337. popped up again with the hotkey. (Same as the Use gadget.)
  338.  
  339. Project/Quit (Hotkey Amiga-Q)
  340.  
  341. This quits WBAssign, but still leaves the assigns created by it in place.
  342.  
  343. Edit/Redo (Hotkey Amiga-R)
  344.  
  345. This clears all the assignments made by WBAssign, and remakes  them,  so  that
  346. the assignments are definitely what the  list  says  they  are.  This  may  be
  347. needed if  you  have  edited  the  assignments  a  lot,  especially  with  Add
  348. assignments which often confuse WBAssign, so the assignments may not  be  what
  349. WBAssign thinks they are, or if another program has changed  the  assignments.
  350. If a program asks for an assignment that you have defined with WBAssign,  then
  351. you should use this to recreate the assign.
  352.  
  353. Edit/Sort (Hotkey Amiga-T)
  354.  
  355. This will alphabetically sort the assigns so that the list looks  neater,  and
  356. also so that multiple assigns will be  grouped  together.  The  sort  is  case
  357. insensitive,  just  like  AmigaDOS,  so  "FONTS:"  and  "Fonts:"  are  grouped
  358.  
  359.  
  360.                                     - 6 -
  361.      WBAssign V1.21                                  December 29, 1993
  362.  
  363.  
  364. together.
  365.  
  366. Edit/Delete All (Hotkey Amiga-D)
  367.  
  368. This clears all the assigns.
  369.  
  370. Edit/Last Saved (Hotkey Amiga-L)
  371.  
  372. This reloads all the assigns that you saved with "Save",  cancelling  all  the
  373. changes since.
  374.  
  375. Edit/Restore (Hotkey Amiga-R)
  376.  
  377. This undoes all the changes since the WBAssign window was opened.
  378.  
  379. 2.3. Workbench Tooltypes
  380.  
  381. WBAssign can be run from both CLI and Workbench.  Generally  it  will  be  run
  382. from Workbench, in which case, the following will be placed  in  the  WBAssign
  383. icon's tooltypes (using Info from Workbench). Even if  WBAssign  is  run  from
  384. the CLI, it will still take the tooltypes from the  icon.  WBAssign  will  not
  385. detach from the CLI, so you may wish to Run it.
  386.  
  387. CX_POPUP (Default YES)
  388.  
  389. This defines whether WBAssign should pop up its window  when  it  is  run.  By
  390. default it does, but if you  have  it  in  your  WBStartup  drawer,  you  will
  391. probably want it not to, by changing it to CX_POPUP=NO.
  392.  
  393. CX_PRIORITY (Default 0)
  394.  
  395. This sets the priority of the hotkey, in relation to all of the other  hotkeys
  396. you have in your system.
  397.  
  398. CX_POPKEY (Default control alt w)
  399.  
  400. This sets the hotkey that you use to pop up the window if it  is  closed.  You
  401. can change this if it clashes with any other hotkey, or if you don't like it.
  402.  
  403. 3. Final words
  404.  
  405. If you need to contact me, to report bugs, offer suggestions for  updates,  or
  406. for any other reason, then contact me. Currently, I can only be  contacted  by
  407. paper mail - please don't use any email address you have for me, they  are  no
  408. longer valid (but watch this space.) The address is:
  409.  
  410. Peter Corlett,
  411. 7 Melbourne Court
  412. Melbourne Street
  413. YORK
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                     - 7 -
  421.